docs: state local MCP key requirements exactly - #251
MagMueller wants to merge 3 commits into
Conversation
There was a problem hiding this comment.
All reported issues were addressed across 2 files
Reply with feedback, questions, or to request a fix.
Fix all with cubic | Re-trigger cubic
There was a problem hiding this comment.
1 issue found across 2 files (changes from recent commits).
Prompt for AI agents (unresolved issues)
Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.
<file name="docs/open-source/llms-full.txt">
<violation number="1" location="docs/open-source/llms-full.txt:2990">
P3: The new OPENAI_API_KEY line says the key is 'Required for extraction', but the Available Tools list groups browser_get_html and browser_screenshot under 'Content Extraction' even though they need no key (as the Model keys table states). A reader who uses get_html/screenshot and sees them under 'Content Extraction' may conclude they need the key. Narrow the wording to the one tool that requires it.</violation>
</file>
Reply with feedback, questions, or to request a fix.
Fix all with cubic | Re-trigger cubic
|
|
||
| - `OPENAI_API_KEY` - Your OpenAI API key (required) | ||
| - `ANTHROPIC_API_KEY` - Your Anthropic API key (alternative to OpenAI) | ||
| - `OPENAI_API_KEY` - Required for extraction and the default autonomous agent. Omit it from the client configurations above if you only use direct browser tools |
There was a problem hiding this comment.
P3: The new OPENAI_API_KEY line says the key is 'Required for extraction', but the Available Tools list groups browser_get_html and browser_screenshot under 'Content Extraction' even though they need no key (as the Model keys table states). A reader who uses get_html/screenshot and sees them under 'Content Extraction' may conclude they need the key. Narrow the wording to the one tool that requires it.
Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/open-source/llms-full.txt, line 2990:
<comment>The new OPENAI_API_KEY line says the key is 'Required for extraction', but the Available Tools list groups browser_get_html and browser_screenshot under 'Content Extraction' even though they need no key (as the Model keys table states). A reader who uses get_html/screenshot and sees them under 'Content Extraction' may conclude they need the key. Narrow the wording to the one tool that requires it.</comment>
<file context>
@@ -2973,12 +2973,42 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
## Environment Variables
-- `OPENAI_API_KEY` - Optional for direct browser control; required for `browser_extract_content` and the default OpenAI-compatible route of `retry_with_browser_use_agent`
+- `OPENAI_API_KEY` - Required for extraction and the default autonomous agent. Omit it from the client configurations above if you only use direct browser tools
- `BROWSER_USE_HEADLESS` - Set to `false` to show browser window
- `BROWSER_USE_DISABLE_SECURITY` - Set to `true` to disable browser security features
</file context>
| - `OPENAI_API_KEY` - Required for extraction and the default autonomous agent. Omit it from the client configurations above if you only use direct browser tools | |
| - `OPENAI_API_KEY` - Required for `browser_extract_content` and the default autonomous agent. Omit it from the client configurations above if you only use direct browser tools |
Clarifies that direct local MCP browser tools do not need an LLM key. Content extraction uses an OpenAI-compatible key. The autonomous agent tool uses that route by default and also supports configured AWS Bedrock credentials. Removes the unsupported Anthropic-key fallback claim.
Validated the absent-OpenAI/Anthropic-only error and the Bedrock routing branch without provider calls. The Bedrock constructor was replaced by a sentinel for routing only; AWS authentication and inference were not tested. Mint found no broken links, docs.json parsed, and git diff --check passed. The generated LLM-readable mirror was synchronized.
Summary by cubic
Clarifies the local MCP server's LLM key requirements so users don't set up unused keys. Direct browser automation tools like navigate, click, type, page state, HTML, and screenshot work without an LLM key; content extraction requires an OpenAI-compatible key, and the default autonomous agent route also uses OpenAI-compatible by default or AWS Bedrock when configured. Removes the unsupported Anthropic-key fallback from environment variables and troubleshooting.
Written for commit 0dd6694. Summary will update on new commits.